When you are done with a controller, use the
TheDisposeMovieController
function to dispose of the controller.NewMovieControllerNewMovieController
function locates a movie controller component for you and assigns a movie to that controller. This function always creates a controller that is attached to a movie.This function is actually implemented by the Movie Toolbox, not by movie controller components. If you are creating your own movie controller component, you do not need to support this function.
pascal MovieController NewMovieController (Movie theMovie, const Rect *movieRect, long someFlags);
theMovie
- Identifies the movie to be associated with the movie controller.
movieRect
- Points to the display rectangle that is to contain the movie and its controller.
someFlags
- Contains flags that control the operation. If you set these flags to 0, the movie controller component centers the movie in the rectangle specified by the
movieRect
parameter and scales the movie to fit in that rectangle. The control portion of the controller is also placed within that rectangle. You may control how the movie and the control are drawn by setting one or more of the following flags to 1:mcTopLeftMovie
- If this flag is set to 1, the movie controller component places the movie into the upper-left corner of the display rectangle specified by the
movieRect
parameter. The component scales the movie to fit into the rectangle. Note that the control portion of the controller may fall outside of the rectangle, depending upon the results of the scaling operation.mcScaleMovieToFit
- If this flag is set to 1, the movie controller component resizes the movie to fit into the display rectangle specified by the
movieRect
parameter after it places the control portion of the controller into the rectangle.- If you set this flag and the
mcScaleMovieToFit
flag to 1, the movie controller component resizes the movie to fit
into the specified rectangle and places the control portion of the controller outside of the rectangle.mcWithBadge
- Controls whether the movie controller uses a badge (see "Badges," which begins on page 2-6, for more information about movie badges). If you set this flag to 1, the movie controller component displays the movie with a badge whenever the controller portion is not displayed. If you set this flag to 0, the movie controller component does not use a badge.
mcNotVisible
- Controls whether the controller portion is visible. If you set this flag to 0, the movie controller component displays the controller along with the movie. If you set this flag to 1, the component does not display the controller. If you have set the
mcWithBadge
flag to 1, specifying that the component uses a badge, the component displays a badge whenever the controller is not visible.mcWithFrame
- Specifies whether the component displays a frame
around the movie as part of the controller. If you set this flag to 1, the component displays a frame around the movie, including the movie's name. If you set this flag to 0, the component does not display a frame as part of the controller.DESCRIPTION
TheNewMovieController
function returns a movie controller identifier value. This value identifies a connection to a movie controller component, and it is a component instance.
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help